home *** CD-ROM | disk | FTP | other *** search
/ Professional Soft Collection 1.02 / Professional Soft Collection 1.02.iso / archivat / arj250.exe / UPDATE.DOC < prev    next >
Text File  |  1995-10-31  |  20KB  |  502 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.50                                     October 1995
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.41.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         THIS VERSION OF ARJ IS AN OFFICIAL RELEASE.
  11.  
  12.         The mailing address of ARJ Software has changed as of August 1993.
  13.  
  14.         ARJ Software
  15.     Robert and Susan Jung
  16.         P.O. Box 249
  17.         Norwood MA 02062
  18.     USA
  19.  
  20.         FAX: 617-769-4893
  21.  
  22.         There is ARJ Internet mailing list and WEB site support
  23.         information added to the file ARJ.DOC.
  24.  
  25.         Beginning with this version of ARJ, full functionality of certain
  26.         ARJ software features will NOT be available in the shareware
  27.         versions of ARJ (registered or not).  These features include the
  28.         multiple volume self-extractor, the ARJSFX embedded command line
  29.         feature, and the inhibit display messages option.  The full
  30.         featured versions will ONLY be available from ARJ Software and
  31.         its agents.  Registered ARJ users can upgrade to this version for
  32.         a small shipping/handling fee ($5).
  33.  
  34.         See ARJDISP.DOC for information about a new feature for software
  35.         distributors using ARJ.
  36.  
  37.         Check the WHATSNEW.DOC file for changes since ARJ 2.41a.
  38.  
  39.         The new multiple volume self-extraction function is LIMITED in the
  40.         ARJ shareware version.  Only volumes of 360K or less in size can be
  41.         created AND only such volumes will be processed by the
  42.         self-extractor.  This feature is accessed through the "-je" option
  43.         along with the "-v" option.
  44.  
  45.         The ARJ Security envelope scheme in 2.50 is the SAME as in 2.41.
  46.         In other words, ARJ-SECURE 2.50 is compatible with 2.41.  There is
  47.         no change in the envelope key files.  However, the 2.50 version
  48.         of this ARJ-SECURE is able to make an archive and "seal" it with
  49.         the same command line.  ARJ-SECURE users can upgrade to this
  50.         version for a small shipping/handling fee ($5).
  51.  
  52.         ARJ can archive up to 32,000 files at one time when the new "-hm"
  53.         option is specified.  This option enables ARJ to use disk space
  54.         instead of memory space to manage the names of the files being
  55.         archived.
  56.  
  57.         Please note that older versions of ARJ.EXE will NOT process the
  58.         new multiple volume self-extractor.  An error message will be
  59.         displayed.
  60.  
  61.         A new option "-w" sets the ARJSFX module to skip the "Continue
  62.         extraction?" message.  This is a change from the former method to
  63.         inhibit the message.
  64.  
  65.         The extraction messages of the large ARJSFX module have been
  66.         shortened in default mode.  A new "-k" option will display the
  67.         long form of the messages.
  68.  
  69.         It is now possible for registered ARJ users to control whether
  70.         the ARJSFX module will display the overwrite, create directory,
  71.         and continue extraction prompts without requiring command line
  72.         options.  It is also possible to control the ARJSFXJR overwrite
  73.         behavior.
  74.  
  75.         A diskette change test will detect the failure to swap diskettes.
  76.         This can cause a problem for those who put more than one volume
  77.         per diskette.  However, this diskette change test is limited to
  78.         three retries, so ARJ will eventually accept the non-change of
  79.         diskette.  The user can inhibit this change test with the new
  80.         "-vi" option.
  81.  
  82.     Whenever archiving to diskettes, it is HIGHLY recommended that the
  83.     option "-jt" be used.  This helps spot BAD diskettes or BAD
  84.     diskette drives.  It is HIGHLY recommended that the "-jt" option
  85.         be used in a Windows or multi-tasking or network environment.
  86.  
  87.     UNERASE or UNDELETE commands do not always recover a file
  88.     correctly.  This will result in damaged archives.  This is true
  89.     for all archive types.    You should always test an archive after
  90.     unerasing it.
  91.  
  92.     If you use the software disk cache, HYPERDISK, see the KNOWN ARJ
  93.     ISSUES section in ARJ.DOC for important information.
  94.  
  95.         CAUTION: To those who use the -t1 and/or -t1g options to save a few
  96.         extra bytes.  This option should only be used on TEXT FILES. Those
  97.         are files created by EDLIN, EDIT, QEDIT, BRIEF, NOTEPAD, and
  98.         others.  Text files typically contain only letters, numbers,
  99.         spaces, and punctuation marks.  WORD PROCESSOR format files ARE NOT
  100.         TEXT FILES!  MS WORD, Wordperfect, AMIPRO, WRITE, and similar files
  101.         ARE NOT TEXT FILES. Using the -t1 or -t1g on any other kind of file
  102.         probably will result in DATA LOSS!
  103.  
  104.      **********************************************************************
  105.  
  106.  
  107.      USER PROMPTS
  108.  
  109.     The ARJ user prompts have been improved to provide more
  110.     flexibility.  In addition to the normal yes and no responses, ARJ
  111.     also accepts the following responses: quit, always, skip, global,
  112.     and command.
  113.  
  114.     "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  115.     YES for all queries as if "-y" were specified.
  116.  
  117.     The "Always" response has changed.  It now sets ARJ to assume YES
  118.     for subsequent queries of the same class.  For example, answering
  119.     YES to the overwrite query will assume YES for ALL subsequent
  120.     overwrite queries.
  121.  
  122.     "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  123.     class.
  124.  
  125.     Subsequent user prompt messages will still be output to the screen
  126.     after the "always" and "skip" responses but no user response will be
  127.     accepted.
  128.  
  129.     "Command" prompts for one DOS command and then executes it.  ARJ
  130.     then returns to expect an answer to the current yes/no query.  You
  131.     should keep the query in mind as ARJ does NOT always redisplay
  132.     the full query message.
  133.  
  134.  
  135.      ARJ ERROR LEVELS
  136.  
  137.     ARJ will now return a DOS errorlevel of 9 when trying to process a
  138.     file that is NOT an ARJ archive.
  139.  
  140.     With the new option "-hl", ARJ will return a non-zero errorlevel
  141.     when a user specified filename from within an ARJ listfile cannot
  142.     be found on disk.  Ordinarily, ARJ returns no error for such a
  143.     situation.
  144.  
  145.  
  146.      ARJ ARCHIVE NAME WILDCARDING
  147.  
  148.     ARJ allows the wildcarding of the archive parameter for ARJ
  149.     commands other than the add commands (a, f, j, m, u).  If the "-r"
  150.     option is specified, ARJ will scan through subdirectories looking
  151.     for ARJ archives to process.
  152.  
  153.     This feature allows a user to delete a specific file from a series
  154.     of archives.
  155.  
  156.     Example:  ARJ d *.ARJ bbs.ad
  157.  
  158.     This feature could also be used to extract a series of archives.
  159.  
  160.     Example:  ARJ e *.ARJ
  161.  
  162.         The new "-hr" option allows ARJ to process multiple archives that
  163.         cause errors.
  164.  
  165.  
  166.      ARJ COMMAND LINE PROCESSING
  167.  
  168.         For non-add type commands, ARJ will now always use the full
  169.         specified pathname for selecting files within an archive by
  170.         matching against the full specified pathname.
  171.  
  172.         Example:  ARJ x archive d:\temp\ f:\data\1994\report.txt
  173.  
  174.         ARJ will now accept an ARJ command line from a response file as in
  175.         "ARJ @command.rsp".  The "@" symbol indicates that the appended
  176.         name is the name of the response file.  In this case, the file is
  177.         command.rsp. The response file symbol cannot be changed.
  178.  
  179.         The response file should contain the ARJ command line minus the
  180.         initial "ARJ".  The command line may be split over as many lines
  181.         as necessary.  The response file feature will NOT accept QUOTED
  182.         command line options.  Options with embedded blanks ("-vasTEST X")
  183.         will not be processed as expected.  When using the response file
  184.         feature, ARJ will accept only the "-+", and "-&" switch options on
  185.         the DOS command line along with the response file name.  All other
  186.         command options must be specified in the response file or in the
  187.         ARJ environment variable.
  188.  
  189.  
  190.      ARJSFX COMMAND LINE PROCESSING
  191.  
  192.         All of the ARJ self-extractors feature a new option to embed any
  193.         command line options into the self-extracting archive itself.  This
  194.         helps reduce the need for extra programs or batch files.
  195.  
  196.         To implement this feature, you would insert the required command
  197.         line as the first line of the ARJ archive comment.  The beginning
  198.         of the command line must be preceded by the two characters "))".
  199.         Only the first 80 characters of the embedded command line will
  200.         be processed.
  201.  
  202.         Example:  )) C:\DIR\ -o -m
  203.  
  204.         The non-shareware version of this software will not display the
  205.         customized command line demonstration message.
  206.  
  207.         The larger ARJ self-extractor (-je) supports the new command line
  208.         option "-s" to allow the skipping of the ARJ-SECURITY envelope
  209.         verification test if an envelope exists.  ARJSFX also supports the
  210.         new "-o" option to force overwrites, the "-m" option to skip the
  211.         create directory prompt, and the "-w" option to skip the extract
  212.         prompt.  The new "-b" option prompts the user for the name of the
  213.         install directory.  The target directory on the command line is
  214.         used as the default install directory.  A new "-k" option will
  215.         display the long form of the file extraction messages.
  216.  
  217.  
  218.      ARJSFXJR COMMAND LINE PROCESSING
  219.  
  220.     The small ARJ self-extractor (-je1) supports command line
  221.     options.
  222.  
  223.     ARJSFXJR [-switch(es)] [drive:][target_dir\]
  224.  
  225.     switches:
  226.     n: set ARJSFXJR to NOT count as an error the skipping of files
  227.     o: set ARJSFXJR to overwrite existing files
  228.  
  229.     You can specify a target_directory or drive or both.  However,
  230.     you must specify the ending "\" or ":" symbol.
  231.  
  232.     ARJSFXJR -o C:\SOFT\  -> self-extract into directory "C:\SOFT\"
  233.                  in overwrite mode.
  234.  
  235.  
  236.      ARJ COMMANDS
  237.  
  238.      "d" command
  239.  
  240.         *** The following information was left out of ARJ.DOC at 2.41 ***
  241.  
  242.         If specify "*.*" as the filespec, ARJ will prompt for permission to
  243.     delete.  You can specify the "-y" or "-jyd" options to inhibit the
  244.     delete prompt.
  245.  
  246.     If ARJ removes all files from an archive, it will delete the empty
  247.     archive.
  248.  
  249.     The delete command normally only deletes non-backup files.  You
  250.     must specify the "-jg" option to select backup files, too.
  251.  
  252.     You can specify the "-n" (new) option to delete the files in the
  253.     archive that DO NOT EXIST on the disk.    You can use the same "-n"
  254.     option with "ARJ l" to list the files that DO NOT EXIST on the
  255.         disk.  This is useful in synchronising an archive to a directory.
  256.  
  257.     Examples:  ARJ d archive *.* -n
  258.                    ARJ l archive temp\ *.doc -n
  259.            ARJ d archive temp\ *.doc -n
  260.  
  261.  
  262.      "f" and "u" commands
  263.  
  264.         As of 2.42c, when updating archives with the -jv option selected,
  265.         ARJ will display a message for each file processed including
  266.         files that have not been updated.  A message indicating that
  267.         there has been "no change" will be displayed when no actual
  268.         update of a file took place.
  269.  
  270.  
  271.      ARJ SWITCHES
  272.  
  273.      "-b4" switch
  274.  
  275.         The "-b4" switch is used to set ARJ to NOT restore any file
  276.         attribute bits and to reset the archive bit of files being
  277.         extracted.  It is useful for easing the cleanup/deletion of
  278.         temporarily extracted archive files as in a virus scanning process.
  279.  
  280.  
  281.      "-b5" switch
  282.  
  283.         This switch used with the "e" or "x" commands sets ARJ to not
  284.         restore any of the original file attributes bits.  However, the
  285.         archive bit will be left set.
  286.  
  287.  
  288.      "-f1" switch
  289.  
  290.         This switch used with the "e" or "x" commands sets ARJ to only
  291.         extract OLDER files from the archive.
  292.  
  293.  
  294.      "-u1" switch
  295.  
  296.         This switch used with the "e" and "x" commands causes ARJ to
  297.         extract OLDER and non-existing files.
  298.  
  299.  
  300.      "-u2" switch
  301.  
  302.         This switch used with the "e" and "x" commands causes ARJ to
  303.         extract CHANGED (different date-time or different size) and
  304.         non-existing files.
  305.  
  306.  
  307.      "-v" switch
  308.  
  309.     When the multiple volume ARJ files to be used are located on drives
  310.     with removable media (diskette drives, etc.), ARJ will ALWAYS
  311.     PROMPT for the next diskette even with the "-y" option specified.
  312.     However, you can suppress the next volume prompt with the "-jyv"
  313.     option.  At DOS versions before 3.0, only drives A and B are
  314.     considered removable.
  315.  
  316.     After the pause to change diskettes, ARJ will check to make sure
  317.     that the diskette has been changed.  However, this check is limited
  318.         to 3 retries for the same volume.  This test can be inhibited with
  319.         the "i" modifier.
  320.  
  321.         Example:  ARJ x a:archive -vi
  322.  
  323.     ARJ will not allow the updating of multiple volume archives unless
  324.     the "-hu" option is specified.
  325.  
  326.     The "r" modifier allows the reservation of disk space on the first
  327.     volume.  The number after the "r" specifies the space to reserve.
  328.     This is useful for software installation volumes built on the hard
  329.     disk.
  330.  
  331.     Example:  ARJ a install -v360r50K   make first volume 50000 bytes
  332.                         smaller than 360K.
  333.  
  334.     Example:  ARJ u archive -v360u
  335.  
  336.     The "z" modifier works like the "s" modifier except that the system
  337.     command is NOT echoed to the screen.
  338.  
  339.     The "-v" switch now accepts its modifiers in any order.  The "s"
  340.     and "z" modifiers must be last because any succeeding text is
  341.     considered the system command to execute.
  342.  
  343.     Examples:  ARJ a volume -vavw         beep, autosize, whole files
  344.            ARJ a volume -vavsDIR     beep, autosize, execute DIR
  345.  
  346.  
  347.      "-je" switch
  348.  
  349.         This switch will create a multiple volume self-extracting archive
  350.         when used with the "-v" switch.  This option combination requires
  351.         DOS 3.0 and above.
  352.  
  353.         Example:  ARJ a a:install c:\software\*.* -je -va
  354.  
  355.  
  356.      "-jf" switch
  357.  
  358.         It is now possible to extract a file stored with an absolute path
  359.         to another directory from an archive containing similar paths
  360.         differentiated only by drive letters.
  361.  
  362.         Example: ARJ x archive d:\temp f:\data\1994\report.*
  363.  
  364.  
  365.      "-js" switch
  366.  
  367.         The "-js" switch will recognize "." alone as a file extension
  368.         indicating no file extension as in "-js." and "-js..arc"
  369.  
  370.  
  371.      "-jv" switch
  372.  
  373.         The "-jv switch will display a "no change" message when updating
  374.         an archive with files that are already up to date.
  375.  
  376.  
  377.      "-h#" switch
  378.  
  379.         The "-h#" switch sets ARJ to append the current date string in
  380.         the form YYMMDD to the current archive name while keeping the
  381.         file extension the same.
  382.  
  383.         The "-h#1" switch sets ARJ to append the current time string in
  384.         the form HHMMSS to the current archive name while keeping the
  385.         file extension the same.
  386.  
  387.         The "-h#2" switch sets ARJ to append the current date-time
  388.         string in the form DHHMMSS to the current archive name while
  389.         keeping the file extension the same.
  390.  
  391.         Examples:  ARJ a XX -h# *.c    creates archive name XX931209.ARJ
  392.                    ARJ a YY -h#1       creates archive name YY123000.ARJ
  393.                    ARJ a Y -h#2        creates archive name Y8123000.ARJ
  394.  
  395.         This function does NO checking for exceeding the proper filename
  396.         length.
  397.  
  398.  
  399.      "-hm" switch
  400.  
  401.         The "-hm" switch sets ARJ to transfer the list of filenames to be
  402.         archived from precious memory to file storage.  This allows a much
  403.         larger number of files to be processed (over 32,000).  This option
  404.         is ignored for all ARJ commands except "a", "f", "j", "m", "u".
  405.  
  406.         Normally, this switch sets ARJ to wait until it is out of memory
  407.         storing filenames into a list before transferring that list to a
  408.         temporary file.  That temporary file is put in the current
  409.         directory or the special work directory if specified (-hm!F:\).
  410.         However, there may be a few cases where ARJ will run out of memory
  411.         doing other tasks while it is storing this list.  In these cases,
  412.         ARJ will abort.  The user can specify a numeric argument to this
  413.         switch to force ARJ to transfer the list to file storage sooner.
  414.         This argument specifies the maximum number of filename entries to
  415.         store in memory.  If the list exceeds that number, the entries are
  416.         transferred from memory to a temporary file.
  417.  
  418.         The "-hm" work directory is specified by appending a "!" to the
  419.         "-hm" or "-hm5000" options and then appending the filename to the
  420.         option.  See below.
  421.  
  422.         Examples:  ARJ a archive c:\*.* -r -hm
  423.                    ARJ a a:archive c:\*.* -r -va -hm5000!F:\
  424.                    ARJ a a:archive c:\*.* -r -hm!G:\temp\
  425.  
  426.         This feature has at least two disadvantages.  The checking for
  427.         duplicate filename specifications may become disabled (ex: *.DOC
  428.         and MANUAL.* duplicates MANUAL.DOC).  Updating archives will become
  429.         slower.  Extra disk space is required for the temporary file list.
  430.         The use of a RAMDISK directory will provide the fastest operation.
  431.  
  432.  
  433.      "-hn" switch
  434.  
  435.         The "-hn" switch sets the filespec that does NOT match any file.
  436.         The default filespec is "...".  However, on some systems like
  437.         NOVELL, there is a valid filespec "...".  Since ARJ sometimes needs
  438.         a filespec that is strictly a placeholder, this option should be
  439.         used to specify some name that does not exist on disk.
  440.  
  441.         This option must be specified prior to any use of the non-matching
  442.         filespec.  Setting it via the ARJ_SW variable is an excellent
  443.         choice.
  444.  
  445.         Example:  ARJ e -hn#### archive #### -zcomment.txt
  446.                   SET ARJ_SW=-hn####
  447.  
  448.  
  449.      "-ho" switch
  450.  
  451.         The "-ho" switch used with the "e" or "x" extract commands allows
  452.         file extraction based upon a text search.  ARJ will prompt the
  453.         user for text strings to search unless the "-jq" option has been
  454.         specified.  See the "-jq" option in ARJ.DOC for detailed use
  455.         information.  ARJ will extract a file within an archive if the
  456.         file contains at least one occurrence of any of the specified
  457.         search strings.
  458.  
  459.         Examples:  ARJ e archive -ho
  460.                    ARJ e archive -ho -jq+3+textstring
  461.  
  462.  
  463.      "-ho1" switch
  464.  
  465.         The "-ho1" switch used with the "e" or "x" extract commands allows
  466.         file extraction based upon a text search.  ARJ will prompt the
  467.         user for text strings to search unless the "-jq" option has been
  468.         specified.  See the "-jq" option in ARJ.DOC for detailed use
  469.         information.  ARJ will extract a file within an archive if the
  470.         file contain NO occurrences of any of the specified search
  471.         strings.
  472.  
  473.         Examples:  ARJ e archive -ho1
  474.  
  475.  
  476.      "-hr" switch
  477.  
  478.         The "-hr" switch sets ARJ to attempt to continue processing
  479.         successive archives even when they contains errors.  This option is
  480.         intended for ARJ wildcard use such as in the "ARJ t *.ARJ -hr"
  481.         command.
  482.  
  483.  
  484.      "-hv" switch
  485.  
  486.         The "-hv" switch is used to verify the ARJ version number and/or
  487.         whether the ARJ program is registered.  If the "-hv" option is
  488.         specified by itself or with an appended "R", an unregistered ARJ
  489.         will abort with an errorlevel of 1.  If a version number string
  490.         is appended to the "-hv" option, a lower version numbered ARJ
  491.         will abort with with an errorlevel of 1.
  492.  
  493.         Examples:  ARJ a archive -hv         check if registered
  494.                    ARJ a archive -hvr        check if registered
  495.                    ARJ a archive -hv2.50     check for version 2.50 or greater
  496.                    ARJ a archive -hvr2.50    check if registered and version
  497.                                              2.50 or greater
  498.  
  499.  
  500.      end document
  501.  
  502.